<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
            "http://www.w3.org/TR/REC-html40/loose.dtd">
<HTML>
<HEAD>



<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<META name="GENERATOR" content="hevea 1.08">
<LINK rel="stylesheet" type="text/css" href="umsroot.css">
<TITLE>
Format of the Tracing Messages
</TITLE>
</HEAD>
<BODY >
<A HREF="umsroot075.html"><IMG SRC ="previous_motif.gif" ALT="Previous"></A>
<A HREF="umsroot074.html"><IMG SRC ="contents_motif.gif" ALT="Up"></A>
<A HREF="umsroot077.html"><IMG SRC ="next_motif.gif" ALT="Next"></A>
<HR>

<H2 CLASS="section"><A NAME="htoc187">14.2</A>&nbsp;&nbsp;Format of the Tracing Messages</H2>
All trace messages are output to the
<B>debug_output</B> stream.
<A NAME="@default763"></A><BR>
<BR>
The format of one trace line is as follows:
<BLOCKQUOTE CLASS="quote">
<PRE CLASS="verbatim">
S+(4) 2 *EXIT&lt;5&gt; module:foo(one, X, two)   %&gt;
12 3  4 5 6   7    8       9              10
</PRE></BLOCKQUOTE>
<OL CLASS="enumerate" type=1><LI CLASS="li-enumerate">
The first character shows some properties of the
displayed procedure.
It may be one of
<UL CLASS="itemize"><LI CLASS="li-itemize">
C - an external procedure, not implemented in Prolog
<LI CLASS="li-itemize">S - a <I>skipped</I> procedure, i.e. a procedure whose
subgoals are not traced
</UL><BR>
<BR>
<LI CLASS="li-enumerate">A '+' displayed here shows that the procedure has a spy point set,
 and a '#' shows that the specific call has a break-point set..
<A NAME="@default764"></A><BR>
<BR>
<LI CLASS="li-enumerate">The number between parentheses shows the box invocation number
of this procedure call. Since each box has a unique invocation
number, it can be used to identify ports that belong to the same box.
It also shows how many procedure redos have been made since the
beginning of the query. Only boxes that can be traced obtain an
invocation number, for instance subgoals of a procedure which is
compiled in debug mode or has its skip-flag set are not numbered.<BR>
<BR>
When a delayed goal is resumed, it keeps the invocation number it was
assigned when it delayed. This makes it easy to follow all ports of a
specified call even in data-driven computation.<BR>
<BR>
<LI CLASS="li-enumerate">The second number shows the level or depth of the goal,
i.e. the number of its ancestor boxes. When a subgoal is called, the
level increases and after exit it decreases again. The initial level
is 1.<BR>
<BR>
Since a resumed goal is considered to be a descendant of the procedure
that woke it, the level of a resumed goal may be different from
the level the goal had when it delayed.<BR>
<BR>
<LI CLASS="li-enumerate">An asterisk before an EXIT means that this
procedure is nondeterministic and that it might be resatisfied.<BR>
<BR>
<LI CLASS="li-enumerate">The next word is the name of the port.
It might be missing if the displayed goal is not the current position
in the execution (e.g. when examining ancestors or delayed goals).
<DL CLASS="description" COMPACT=compact><DT CLASS="dt-description">
<B>CALL</B><DD CLASS="dd-description"> a procedure is called for the first time concerning a particular
invocation,<BR>
<BR>
<DT CLASS="dt-description"><B>DELAY</B><DD CLASS="dd-description"> a procedure delays,<BR>
<BR>
<DT CLASS="dt-description"><B>EXIT</B><DD CLASS="dd-description"> a procedure succeeds,<BR>
<BR>
<DT CLASS="dt-description"><B>FAIL</B><DD CLASS="dd-description"> a procedure fails, there is no (other) solution,<BR>
<BR>
<DT CLASS="dt-description"><B>LEAVE</B><DD CLASS="dd-description"> a procedure is left before having failed or exited because
of a call to <A HREF="../bips/kernel/control/exit_block-1.html"><B>exit_block/1</B></A><A NAME="@default765"></A>,<BR>
<BR>
<DT CLASS="dt-description"><B>NEXT</B><DD CLASS="dd-description"> the next possibly matching clause of a procedure is tried
because unification failed or a sub-goal failed,<BR>
<BR>
<DT CLASS="dt-description"><B>ELSE</B><DD CLASS="dd-description"> the next branch of a disjunction is tried because some goal
in the previous branch failed.<BR>
<BR>
<DT CLASS="dt-description"><B>REDO</B><DD CLASS="dd-description"> a procedure that already gave a solution is called again for
an alternative,<BR>
<BR>
<DT CLASS="dt-description"><B>RESUME</B><DD CLASS="dd-description"> a procedure is woken (the flow enters the procedure box as for
a call) because of a unification of a suspending variable,</DL><BR>
<BR>
<LI CLASS="li-enumerate">This only appears if the goal is executing at a different priority
 than 12, the normal priority. The number between the angled brackets
 shows the priority (between 1 and 11) that the goal is executed at. <BR>
<BR>
<LI CLASS="li-enumerate">For the tty debugger, the optional module name followed by a colon.
Printing of the module can be enabled and disabled by the debugger
command <B>m</B>. 
<A NAME="@default766"></A>
If it is enabled, the module from where the procedure is called is
displayed. By default the module printing is disabled. With tkeclipse, the
module name is not displayed with the traceline, instead, you can get the
information by right holding the mouse button over the trace line in the
call stack window.<BR>
<BR>
<LI CLASS="li-enumerate">The goal is printed according to the current instantiations
of its variables. Arguments of the form <TT>...</TT> represent subterm
that are not printed due to the depth limit in effect.
The depth limit can be changed using the
<A NAME="@default767"></A>
<B>&lt;</B> command.<BR>
<BR>
The goal is printed with the current <B>output_mode</B> settings.
which can be changed using the
<A NAME="@default768"></A>
<B>o</B> command.<BR>
<BR>
<LI CLASS="li-enumerate">The prompt of the debugger, which means that it is waiting
for a command from the user. Note there is no prompt when tkeclipse tracer
is used.
</OL>
<HR>
<A HREF="umsroot075.html"><IMG SRC ="previous_motif.gif" ALT="Previous"></A>
<A HREF="umsroot074.html"><IMG SRC ="contents_motif.gif" ALT="Up"></A>
<A HREF="umsroot077.html"><IMG SRC ="next_motif.gif" ALT="Next"></A>
</BODY>
</HTML>
